package io.adrainty.bolee.security.repository;

import com.baomidou.mybatisplus.core.metadata.IPage;
import io.adrainty.bolee.framework.commons.user.UserEntity;
import io.adrainty.bolee.security.models.bo.UserRoleBO;
import jakarta.annotation.Nullable;

import java.util.List;

/**
 * @author AdRainty
 * @version V1.0.0
 * @since 2025/8/3 上午1:04
 */

public interface IUserRepository {

    /**
     * 查询用户分页
     *
     * @param entity 查询条件
     * @param pageNum 页码
     * @param pageSize 页大小
     * @return 用户分页
     */
    IPage<UserEntity> findUserPage(UserEntity entity, Integer pageNum, Integer pageSize);

    /**
     * 更新用户
     *
     * @param entity 用户信息
     * @return 是否创建成功
     */
    boolean updateUser(UserEntity entity);

    /**
     * 查询用户列表
     *
     * @param entity 查询条件
     * @return 用户列表
     */
    List<UserEntity> listUser(UserEntity entity);

    /**
     * 根据用户名查找用户
     *
     * @param username 用户名
     * @param company  公司
     * @return 用户
     */
    @Nullable
    UserEntity findByUsername(String username, String company);

    /**
     * 根据手机号查找用户
     *
     * @param mobile  手机号
     * @param company 公司
     * @return 用户
     */
    @Nullable
    UserEntity findByMobile(String mobile, String company);

    /**
     * 根据微信openId查找用户
     *
     * @param openId  微信openId
     * @param company 公司
     * @return 用户
     */
    @Nullable
    UserEntity findByOpenId(String openId, String company);

    /**
     * 保存用户
     *
     * @param userEntity 用户
     * @return 是否保存成功
     */
    boolean save(UserEntity userEntity);

    /**
     * 批量保存用户角色
     *
     * @param userRoleBOList 用户角色
     */
    boolean saveBatchRole(List<UserRoleBO> userRoleBOList);

    /**
     * 根据用户ID批量删除用户角色
     *
     * @param userId 用户id
     */
    void deleteUserRoleByUserId(Long userId);

    /**
     * 根据角色ID批量查询用户角色
     *
     * @param roleId 角色id
     * @return 用户角色
     */
    List<UserRoleBO> findUserRoleListByRoleId(Long roleId);

}
